home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1992 June: ROMin Holiday / ADC Developer CD (1992-06) (''ROMin Holiday'')_iso / Developer Connection - 06-1992.iso / Development Platforms / Apple II / Essentials / GSBug / Templates.Info < prev   
Encoding:
Text File  |  1990-08-21  |  3.6 KB  |  185 lines  |  [TEXT/pdos]
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                         GSBug Templates Release Notes
  7.                                 Version 1.0d3
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.                         Written by:  James M. Luther
  31.  
  32.                                Copyright 1990
  33.                             Apple Computer, Inc.
  34.                             All rights reserved.
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62. Revision History
  63.  
  64. Date       Version  Who  Description Of Changes
  65. ---------  -------  ---  --------------------------
  66. 01-Mar-90  1.00d1   JML  Initial draft of document.
  67. 18-Jun-90  1.00d2   JML  Cleanup for release.
  68. 18-Jun-90  1.00d3   JML  Fixed Print Manager templates PrStyleRec and PrRec.
  69.  
  70.  
  71. About the templates
  72.  
  73. This is a complete set of templates for the Apple IIGS system software 5.0.2.
  74. It includes templates for almost all toolbox records, GS/OS parameter blocks,
  75. FST specific parameter blocks, and ProDOS 16 parameter blocks.  GSBug cannot
  76. support variable length data structures, so those data structures were either
  77. implemented partially (up to the point where the structure becomes variable
  78. length) or were not included.
  79.  
  80.  
  81. Very briefly, here's how to use the templates:
  82.  
  83.   Type "LoadTemp GSBug.Templates" to load the template file.
  84.  
  85.   Type "_name address" to view the memory starting at 'address' through the
  86.   template specified by 'name'.
  87.  
  88.  
  89. About the help templates
  90.  
  91. Help templates are included in GSBug.Templates, so you don't have to remember
  92. what data structures are templated or how to spell the template names.  A help
  93. template will display a list of template names for the toolset or part of the
  94. operating system you specify.
  95.  
  96.   Type "_Templates 0" to see the names of all the toolsets and operating
  97.   system parts.  For example, with this release, you'll see this:
  98.  
  99.         Templates
  100.  
  101.         ADB
  102.         AppleShareFST
  103.         Controls
  104.         Dialogs
  105.         Events
  106.         Fonts
  107.         GSOS
  108.         HighSierraFST
  109.         LineEdit
  110.         Lists
  111.         Locator
  112.         Menus
  113.         MiscTool
  114.         NoteSeq
  115.         NoteSyn
  116.         Print
  117.         ProDOS16
  118.         ProDOSFST
  119.         QDAux
  120.         QuickDraw
  121.         Resources
  122.         SANE
  123.         Sound
  124.         StdFile
  125.         TextEdit
  126.         Windows
  127.  
  128.  
  129.   Type "_toolSetName 0" where toolSetName is one of the names shown by
  130.   "_Templates 0" to list the template names for that toolset or operating
  131.   system part.  For example, to see the templates for the Print Manager,
  132.   you'd type "_Print 0" and you'd see this:
  133.  
  134.         Print
  135.  
  136.         PrInfoRec
  137.         PrJobRec
  138.         PrRec
  139.         PrStatusRec
  140.         PrStyleRec
  141.  
  142.  
  143. About template formatting characters
  144.  
  145. Several of the data structures included in this template file have
  146. substructures imbedded in them (for example, in a GrafPort, the portInfo
  147. field is a LocInfo structure). To highlight the substructure fields in a
  148. structure, I've prefixed each field name with a ">" character.  For example,
  149. here's what the GrafPort template looks like:
  150.  
  151.         _START  GrafPort
  152.         portInfo(LocInfo)
  153.         >portSCB    WORD
  154.         >ptrToPixImage  LONG
  155.         >width  WORD
  156.         >boundsRect WORD    4
  157.         portRect    WORD    4
  158.         clipRgn LONG
  159.         visRgn  LONG
  160.         bkPat   BYTE    32
  161.         pnLoc   WORD    2
  162.         pnSize  WORD    2
  163.         pnMode  WORD
  164.         pnPat   BYTE    32
  165.         pnMask  BYTE    8
  166.         pnVis   WORD
  167.         fontHandle  LONG
  168.         fontID  LONG
  169.         fontFlags   WORD
  170.         txSize  WORD
  171.         txFace  WORD
  172.         txMode  WORD
  173.         spExtra LONG
  174.         chExtra LONG
  175.         fgColor WORD
  176.         bgColor WORD
  177.         picSave LONG
  178.         rgnSave LONG
  179.         polySave    LONG
  180.         grafProcs   LONG
  181.         arcRot  WORD
  182.         userField   LONG
  183.         sysField    LONG
  184.         _END
  185.